home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3s / system.z / system
Encoding:
Text File  |  1998-10-20  |  3.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ssssyyyysssstttteeeemmmm((((3333SSSS))))                                                          ssssyyyysssstttteeeemmmm((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_yyyy_ssss_tttt_eeee_mmmm - issue a shell command
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_dddd_llll_iiii_bbbb_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _ssss_yyyy_ssss_tttt_eeee_mmmm _((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_iiii_nnnn_gggg_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _ssss_yyyy_ssss_tttt_eeee_mmmm causes the _s_t_r_i_n_g to be given to the shell [see _ssss_hhhh(1)] as input,
  18.      as if the string had been typed as a command at a terminal.  The current
  19.      process waits until the shell has completed, then returns the exit status
  20.      of the shell in the format specified by _wwww_aaaa_iiii_tttt_pppp_iiii_dddd(2).
  21.  
  22.      If _s_t_r_i_n_g is a _NNNN_UUUU_LLLL_LLLL pointer, _ssss_yyyy_ssss_tttt_eeee_mmmm checks if _////_ssss_bbbb_iiii_nnnn_////_ssss_hhhh exists and is
  23.      executable.  If _////_ssss_bbbb_iiii_nnnn_////_ssss_hhhh is available, _ssss_yyyy_ssss_tttt_eeee_mmmm returns non-zero; otherwise
  24.      it returns zero.
  25.  
  26.      _ssss_yyyy_ssss_tttt_eeee_mmmm fails if one or more of the following are true:
  27.  
  28.      _EEEE_AAAA_GGGG_AAAA_IIII_NNNN      The system-imposed limit on the total number of processes
  29.                  under execution by a single user would be exceeded.
  30.  
  31.      _EEEE_IIII_NNNN_TTTT_RRRR       _ssss_yyyy_ssss_tttt_eeee_mmmm was interrupted by a signal.
  32.  
  33.      _EEEE_NNNN_OOOO_MMMM_EEEE_MMMM      The new process requires more memory than is allowed by the
  34.                  system-imposed maximum _MMMM_AAAA_XXXX_MMMM_EEEE_MMMM.
  35.  
  36. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  37.      _eeee_xxxx_eeee_cccc(2), _wwww_aaaa_iiii_tttt_pppp_iiii_dddd(2), _ssss_hhhh(1).
  38.  
  39. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  40.      _ssss_yyyy_ssss_tttt_eeee_mmmm forks to create a child process that in turn execs _////_ssss_bbbb_iiii_nnnn_////_ssss_hhhh in
  41.      order to execute _s_t_r_i_n_g.  If the fork or exec fails, _ssss_yyyy_ssss_tttt_eeee_mmmm returns -1
  42.      and sets _eeee_rrrr_rrrr_nnnn_oooo.
  43.  
  44. NNNNOOOOTTTTEEEESSSS
  45.      Calling _ssss_yyyy_ssss_tttt_eeee_mmmm(3S) in a program that is set user ID to _rrrr_oooo_oooo_tttt is difficult
  46.      to do without creating unintended security problems.  For example, since
  47.      _ssss_yyyy_ssss_tttt_eeee_mmmm invokes a copy of _ssss_hhhh(1) to execute the supplied command, the
  48.      programmer must be extremely careful not to allow critical environment
  49.      variables, such as _PPPP_AAAA_TTTT_HHHH, which determine the behavior of the shell to be
  50.      passed through from the environment of the invoking user without
  51.      modification.  It is recommended that _ssss_yyyy_ssss_tttt_eeee_mmmm(3S) not be used by set user
  52.      ID programs.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.